Skip to main content

Select Option

Overview


Selects item(s) from a dropdown list.

Input

Browser

NameRequiredDescription
Browser InstanceWhich browser instance to run against.
Target (Selector)A Selector string that targets a specific element on the web page.

Target Options

NameRequiredDescription
Match TypeMatch Text either behaves as Regex or a simple Contains text check.
Match TextMatches elements that either contain this or match the regex somewhere inside the selected element, possibly in a child or a descendant element.
Match Index (Nth)(Optional) Target the Nth instance of the element. Eg. For 2 of the same element, use an Index of 0 to match the First and 1 to match the Second.
Frame Target (Selector)(Optional) Specify a Frame Selector, for example to first target an iframe before the primary Target.
NameRequiredDescription
Dropdown ValuesValues of the dropdown items to select.

Options

NameRequiredDescription
Timeout (ms)How long to wait in milliseconds for a successful click. Default is 30s.

Advanced Options

NameRequiredDescription
Force SetForces the select, overriding the auto-wait checks that make sure the element is ready to be clicked.
Prevent WaitEnable only if you must avoid waiting for navigation when it is required by certain web page actions to start their page loading, only required in exceptional situations like navigating to inaccessible pages.

Output

NameRequiredDescription
Action SuccessTrue if the action passed, false if it failed.